---
title: ServiceNow
sidebarTitle: ServiceNow
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/servicenow/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/servicenow/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ⚠️ Conditional | A [ServiceNow Developer Instance](https://developer.servicenow.com/dev.do) is free, but production instances require a paid subscription. |
| Paid test account | ✅ Not required | Free developer instance can be used for testing. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | |
| Security audit | ✅ Not required | |


## Setup guide

<Steps>
  <Step title="Create a ServiceNow Developer Account">
    1. Go to the [ServiceNow Developer Portal](https://developer.servicenow.com/dev.do).
    2. Click **Sign up and Start Building** to create a new account if you don't already have one.
    3. Complete the registration process.
  </Step>
  <Step title="Request a Personal Developer Instance (PDI)">
    1. After logging in to the Developer Portal, navigate to **Start Building**.
    2. Click **Request Instance**.
    3. Select the latest ServiceNow release version.
    4. Wait for your instance to be provisioned (this usually takes a few minutes).
    5. Once provisioned, you'll receive an email with your instance details, including the URL, admin username, and password.
  </Step>
  <Step title="Log in to your ServiceNow instance">
    1. Navigate to your instance URL (typically in the format `https://[your-instance-name].service-now.com/`).
    2. Log in with the admin credentials provided in the email.
  </Step>
  <Step title="Create an OAuth API endpoint for external clients">
    1. In your ServiceNow instance, navigate to **System OAuth** > **Application Registry**.
    2. Click **New** to create a new OAuth application.
    3. Select **Create an OAuth API endpoint for external clients**.
    4. Fill in the following fields:
       - **Name**: Enter a descriptive name for your application.
       - **Client ID**: This will be auto-generated.
       - **Client Secret**: This will be auto-generated.
       - **Redirect URL**: Enter `https://api.nango.dev/oauth/callback`.
    5. Click **Submit** to create the application.
  </Step>
  <Step title="Configure OAuth scopes">
    1. In the Application Registry, find and open your newly created application.
    2. In the **Application Scope** tab, click **Add**.
    3. Search for and select the API scopes your application needs. Common scopes include:
       - **admin**: Full administrative access
       - **user_admin**: User administration
       - **user**: Access to user data
       - **useraccount**: Access to user account data
       - **web_service_admin**: Web service administration
       - **web_service**: Access to web services
       - **personalize**: Personalization capabilities
       - **impersonate**: Ability to impersonate users
    4. Click **Save** to apply the selected scopes.
  </Step>
  <Step title="Configure OAuth policies">
    1. In your application record, navigate to the **OAuth Policies** tab.
    2. Configure the following settings:
       - **Access Token Lifespan**: Default is 30 minutes (1800 seconds). You can adjust this as needed.
       - **Refresh Token Lifespan**: Default is 8 hours (28800 seconds). You can adjust this as needed.
       - **Refresh Token Count**: Set to "Unlimited" to allow continuous refreshing of tokens.
    3. Click **Update** to save your changes.
  </Step>
  <Step title="Obtain your OAuth credentials">
    1. In the Application Registry, open your application.
    2. Note the **Client ID** and **Client Secret** values.
    3. Also note your instance URL, as you'll need this for the authorization and token endpoints.
  </Step>
  <Step title="Configure your integration in Nango">
    When setting up your ServiceNow integration in Nango:
    
    - Use your **Client ID** and **Client Secret** from the previous step
    - For the authorization URL, use: `https://[your-instance-name].service-now.com/oauth_auth.do`
    - For the token URL, use: `https://[your-instance-name].service-now.com/oauth_token.do`
    - Replace `[your-instance-name]` with your actual ServiceNow instance name
  </Step>
  <Step title="Next">
    Follow the [_Quickstart_](/getting-started/quickstart).
  </Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>


## Useful links

-   [ServiceNow Developer Portal](https://developer.servicenow.com/dev.do)
-   [ServiceNow Documentation](https://docs.servicenow.com/)
-   [ServiceNow Community](https://community.servicenow.com/)
-   [OAuth Applications](https://docs.servicenow.com/bundle/vancouver-platform-security/page/administer/security/concept/c_OAuthApplications.html)
-   [Create OAuth API Endpoints](https://docs.servicenow.com/bundle/vancouver-application-development/page/build/pipelines-and-deployments/task/create-oauth-api-endpoints-for-external-clients.html)
-   [OAuth Scopes](https://docs.servicenow.com/bundle/tokyo-application-development/page/administer/security/task/t_SpecifyAnOAuthScope.html)
-   [REST API Documentation](https://developer.servicenow.com/dev.do#!/reference/api/vancouver/rest/c_TableAPI)
-   [API Explorer](https://developer.servicenow.com/dev.do#!/reference/api-explorer)
-   [API Best Practices](https://developer.servicenow.com/dev.do#!/guides/vancouver/now-platform/api-best-practices/api-best-practices-overview)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/servicenow.mdx)</Note>

## Common Scopes

| Scope | Description |
| ----- | ----------- |
| admin | Full administrative access |
| user_admin | User administration capabilities |
| user | Access to user data |
| web_service | Access to web services |
| personalize | Personalization capabilities |
| useraccount | Access to user account data |

## API gotchas

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/servicenow.mdx)</Note>
